home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / linkedit / linkedit.lha / link-edit / link_edit.doc < prev    next >
Encoding:
Text File  |  1991-03-14  |  3.8 KB  |  87 lines
  1. Toolchest
  2.  
  3.     In this month's toolchest we describe a program for interactively
  4. editing link projections.  Conceptually, a link (in 3 dimensions) is
  5. a collection of non-intersecting closed curves.  A link projection
  6. is an orthographic projection of such a link onto a plane, with
  7. over/under crossings appropriately marked.  Topologically the link
  8. projection contains all the information of the link.  Moreover, a
  9. link projection is somewaht easier to visualize and edit.
  10.  
  11.      The program is written in "vanilla" XWindows, and *should*
  12. compile and run on any machine running X.  To date it has been
  13. tested on Sun3, Sun4, and SGI architectures.  The makefile uses
  14. ranlib to create library archives, which may cause problems
  15. on some versions of Unix.
  16.  
  17.     As usual the source, makefile, and this article are available via
  18. anonymous ftp from our site: poincare.geom.umn.edu.  The files are
  19. contained in the compressed tar file link_edit.tar.Z in the 
  20. directory ~ftp/pub.
  21.  
  22.     The picture shows the link editor while it is being used.
  23. Visually the program is divided into two areas: the drawing area
  24. and the menu area.  Naturally, all editing/selecting is done with the
  25. mouse, and the menu selections determine the effect of the mouse in the
  26. editing window.  The program is highly modal, with the current mode
  27. always being clearly visible in the menu area.  The basic units of
  28. editing are Points and Strands:  A strand is an (open or closed)
  29. sequence of points, and the link is made up of several strands, together
  30. with over/under crossing information wherever strands intersect.
  31.  
  32.     Following is a brief description of each menu item:
  33.  
  34. Get Link File:  Read a link from a file. 
  35.                 Some sample files are contained in the Examples
  36.                 directory.
  37.  
  38. Save Link File:  Save the link to a file.  The format is particular
  39.                 to this program, but is ascii readable.  The extension
  40.                 ".lnkp" (for link_projection) is automatically 
  41.                 added and only files with this extension are
  42.                 presented for choosing.
  43. Save Link PS:   Save a postscript file of the drawing.  The extension
  44.                 ".ps" is automatically added.
  45. Save Link 3D:   Save as actual 3d strands, where the over/under
  46.                crossings are now implicit in the 3d coordinates.
  47.                The format is the same as the Geometry Project LINK
  48.                format.  The extension ".lnk" is automatically added.
  49. Clear:   Clear the current link and start over.
  50. Settings:  Toggle the following parameters:
  51.  
  52.            Hide/Show Rulers   
  53.            Hide/Show Arrows
  54.            Hide/Show Vertices
  55.            Hide/Show Axes
  56. QUIT:   Exit the link editor.
  57.  
  58.  
  59. Add Point:  Add a point to the current link.  This mode is smart enough to
  60.             know that a link should be closed when clicking near the
  61.             starting point, and that a point should be added interior
  62.             to an edge when clicking near that edge. 
  63. Move Point:  Move a point of any strand.
  64. Delete Point:  Delete a point from any strand.
  65. Close Strand:  Close a strand.
  66. Open Strand:   Open a closed strand.
  67. Join Strands:  Join two strands into one.
  68.  
  69. Move Strand:  Select and move a strand.
  70. Flip Crossing:  Flip over/under crossing of any strand.
  71. Reverse Arrows:  Reverse a strand's direction.
  72. Delete Strand: Delete strands.
  73. Select Strand:  Select a strand to be the current one.
  74.  
  75. Hide Strand:   Select and hide a strand.
  76. Show All:  Show all strands.
  77.  
  78. Shift View:  Move the view.
  79. Zoom View:  Zoom the view.
  80. Center View: Center the link in the editing window.
  81.  
  82. BUGS:  The center view button sometimes needs to be applied twice to work.
  83.        The file chooser truncates filenames to 10 characters.
  84.        The postscript files are mirror reversals of the original,
  85.           they come out smaller than you probably want, and they don't
  86.           include the direction arrows.
  87.